home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu357.dms / pu357.adf / CanonStudio / ReadMe < prev    next >
Text File  |  1992-09-26  |  46KB  |  1,242 lines
  1.  
  2.  
  3.                  C A N O N S T U D I O  V 1.2
  4.                  ============================
  5.  
  6.  
  7.  
  8.                           COPYRIGHT
  9.                           ---------
  10.  
  11. COPYRIGHT   ©   1992   WOLF  FAUST.   ALL  RIGHTS  RESERVED.   ALL
  12. DISTRIBUTION-  AND  MARKETING RIGHTS TO THE SOFTWARE ARE VESTED IN
  13. WOLF FAUST.
  14.  
  15. COPYRIGHT:    THIS  PRODUCT  ("CANONSTUDIO")  IS  COPYRIGHTED  AND
  16. OTHERWISE  SUBJECT  TO  PROPRIETY  RIGHTS.   YOU  MAY NOT COPY, OR
  17. TRANSFER  THE  PRODUCT  OR  ANY  COPY  OR  PORTION THEREOF WITHOUT
  18. WRITTEN PERMISSION FROM THE AUTHOR WOLF FAUST.
  19.  
  20. DISCLAIMER:   THE  PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  21. ANY  KIND, EITHER EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE.  THE
  22. ENTIRE  RISK  AS TO USE, RESULTS AND PERFORMANCE OF THE PRODUCT IS
  23. ASSUMED BY YOU.
  24.  
  25. LIMITATION OF LIABILITY:
  26. IN  NO  EVENT  SHALL  CANON  AND/OR FAUST OR ITS SUPPLIERS BE HELD
  27. LIABLE  FOR  ANY  LOSS  OR DAMAGES ARISING OUT OF ANY ACTION, FROM
  28. WHATEVER  SOURCE,  CONCERNING  THE  USE  OR  INABILITY  TO USE THE
  29. PRODUCT.
  30.  
  31.  
  32.  
  33.                           REGISTERING
  34.                           -----------
  35.  
  36. Please  register  CanonStudio or this product will most likely not
  37. be  supported  in  the  future (programs do cost more than time to
  38. develop).  Also, your sharefee is my motivation for enhancements.
  39.  
  40. The price for registering is:
  41.  
  42.  
  43.                        INTERNATIONAL
  44.  
  45.         US$25   includes shiping
  46.       +   $ 5   if payed by cheque. No COD!
  47.  
  48.  
  49.  
  50.                          GERMANY
  51.  
  52.         DM 35   includes shiping. No COD (Nachnahme)!
  53.  
  54.  
  55.  
  56.                          ENGLAND
  57.           £15   includes shiping
  58.  
  59.  
  60.  
  61. Send the money to following address:
  62.  
  63. Wolf Faust
  64. Am Dorfgarten 10
  65. W-6000 Frankfurt 50
  66. Germany
  67.  
  68. Tel: ++49-69-5486556 (GMT)
  69. Fido:       2:249/3.5 (Wild Cat: ++49-6173-2544 HST,V.32bis)
  70. email:   wfaust@aurea.hotb.sub.org
  71.  
  72.  
  73. Or in England you may register and get updates at/from:
  74.  
  75. JAM
  76. Jeff Walker
  77. 75 Greatfields Drive
  78. Uxbridge, UB8 3QN
  79.  
  80. Tel: 08952-74449 (GMT)
  81.  
  82. What do you get in return:
  83.  
  84. - CanonStudio registered version
  85. - .030 version (approx. 10-20% faster)
  86. - update service (I take that very serious!)
  87.  
  88.  
  89.  
  90.  
  91.                           TRADEMARKS
  92.                           ----------
  93.  
  94. Amiga is a registered trademark of Commodore-Amiga, Inc.
  95. Kickstart is a registered trademark of Commodore-Amiga, Inc.
  96. Workbench is a registered trademark of Commodore-Amiga, Inc.
  97. Deluxe Paint is a registered trademark of Electronics Art.
  98.  
  99. All  other  trademarked  product and company names used herein are
  100. used   for  identification  purposes  only.   No  infringement  of
  101. trademarks   is  intended.   Trademarks  remain  property  of  the
  102. trademark holder.
  103.  
  104.  
  105.  
  106.                         INTRODUCTION
  107.                         ------------
  108.  
  109. CanonStudio is a new program which is intended for all Amiga Canon
  110. printer  drivers.   It  does  print IFF graphics with up to 24 bit
  111. color   accuracy   in   any  size  (Want  a  100*100m  poster?)  .
  112. CanonStudio  is  not limited to the max.  4096 colors of the Amiga
  113. printer  device, though it does work with nearly all Amiga printer
  114. drivers.   The  pictures are printed FROM DISK ie.  you don't need
  115. much memory for printing a 10MByte 24 Bit graphic in high quality.
  116.  
  117. CanonStudio  is  specially  written for the Amiga operation system
  118. and  is not just a simple portation from an IBM or Apple computer.
  119. Because  of  this, CanonStudio makes heavy use of multitasking and
  120. Kickstart  2.04.   CanonStudio includes a spooler which allows you
  121. to  specify  multiple  print  jobs  while  the  program is already
  122. printing   in   background.   The  program  does  provide  a  nice
  123. "click-and-drag" user interface and an ARexx interface.
  124.  
  125. From  my  experience,  most Canon printer owners do print pictures
  126. using  ADPro's  PrefPrinter  saver or TruePrint.  CanonStudio does
  127. offer  users  an easy and inexpensive way for printing pictures in
  128. high  quality.   Using  the  ARexx-Interface,  CanonStudio  can be
  129. controlled   by   other   programs   like  ADPro  or  Black  Belts
  130. Imagemaster.
  131.  
  132. Now, here are some of the CanonStudio features:
  133.  
  134. - prints IFF ILBM pictures from disk
  135.  
  136. - supports most of the known IFF ILBM formats, including HAM8,
  137.   HAM, EHB and color palettes up to 256 colors.
  138.  
  139. - does not require $&%$ MBytes memory!
  140.  
  141. - Allows you to print poster size images spread over multiple
  142.   pages.
  143.  
  144. - number of copies can be defined
  145.  
  146. - Using  CanonStudio you  can  print 24 bit-planes of color accuracy
  147.   on  a  color  printer  (for  instance CanonBJC800).  If you have a
  148.   black and white only printer, then you can print with 8 bit-planes
  149.   of grey scale accuracy.
  150.  
  151.  
  152. - multiple jobs can be defined and printed in background
  153.   (estimated print time and more will be displayed)
  154.  
  155. - ink compensation does correct ink impurities
  156.  
  157. - color adjustment (gamma, contrast, brightnes, weights,...)
  158.  
  159. - Free defineable ordered dither routines. Following ordered
  160.   dither matrices are already included:
  161.   Haltone-A, Halftone-B, Ordered-A, Ordered-B, Spiral, Horizontal,
  162.   Vertical, Bck-Diagonal, Fwd-Diagonal
  163.  
  164. - Three error diffusion dither routines:
  165.   Floyd Steinberg, Jarvis, Stucki
  166.  
  167. - Two serpentine blue noise dither routines are included:
  168.   30% random weight, 50% random weight
  169.  
  170. - ARexx Interface
  171.  
  172. - font independent user interface (KS 2.04 style)
  173.  
  174.  
  175.  
  176.                         ABOUT THIS MANUAL
  177.                         -----------------
  178.  
  179. Sorry for this limited manual.  I'm sure most things can easily be
  180. understood  by  simply using the "try and error" method.  I simply
  181. don't have the time yet to describe all those nice features hidden
  182. in  the  program in detail.  This will hopefully be addressed in a
  183. future  release.  Nearly every function is covered by this manual,
  184. though, most things should be better explained.
  185.  
  186.  
  187.                            HISTORY
  188.                            -------
  189.  
  190. Following driver revisions have been made:
  191.  
  192. 05.09.92     Version 1.0  First Version
  193. 08.09.92     Version 1.1  "Vertical Aspect" set in preferences
  194.                           caused wrong sized printing
  195.                           (a left bar) - fixed
  196. 09.09.92     Version 1.2  Remaining time not shown if
  197.                           print = page dimension - fixed
  198.                           a bug made it into V1.1 Blue-Noise color
  199.                           dump routine causing "cyan-spots" - fixed
  200.  
  201.  
  202.  
  203.                           INSTALLATION
  204.                           ------------
  205.  
  206. What does CanonStudio requires:
  207.  
  208. - an Amiga with at least Kickstart/Workbench 2.04
  209. - ~300KB memory (so it even runs on a plain Amiga 500)
  210. - a Canon printer driver (at least CanonBJ130 V11.1, CanonBJ10 V4,
  211.   CanonBJC V1, CanonLBP V3, CanonBJ300 V4.1)
  212.  
  213. For  installing  CanonStudio  simply drag the CanonStudio icon and
  214. Dither-Settings  drawer  into  the  wanted  drawer.  That's all...
  215. simple, isn't it?
  216.  
  217. WARNING: IF STARTED FROM WORKBENCH, MAKE SURE STACK IS SET TO AT LEAST
  218. 10000   BYTES   OR  CANONSTUDIO  WILL  CRASH!!!
  219.  
  220. In case you have the original icon as distributed, stack is set to
  221. 10000   allready.   Stack  can  be  set  using  the  "Information"
  222. workbench   menu.    When   started  from  Shell/CLI,  CanonStudio
  223. automaticly allocates it's stack.  Because of this, you don't need
  224. to set stack from Shell/CLI.
  225.  
  226.  
  227.  
  228.                       LAUNCHING CANONSTUDIO
  229.                       ---------------------
  230.  
  231. CanonStudio  may be run from either Workbench or a Shell.  When it
  232. starts,   it   looks   for   a   file   in  its  directory  called
  233. "CanonStudio.prefs"   that  contains  your  last  used  and  saved
  234. settings for printing.  In case the setting file can not be found,
  235. CanonStudio  uses  it's  default  internal settings.  You may also
  236. have your own settings file.
  237.  
  238. CanonStudio can be launched from Workbench by double clicking on
  239. its icon. The CanonStudio icon has one tool type to specify its
  240. setting file.
  241.  
  242. The tool type is
  243.  
  244.             SETTINGS=<settingsfile>
  245.  
  246. where <settingsfile> is the name of a settings file for CanonStudio
  247. preferences. The default settings file is "CanonStudio.prefs" in
  248. the program directory containing the CanonStudio executable.
  249. Also, there are several tool type options which allow you to
  250. override the settings of the settings file. These options are
  251. named the same way as the Shell options are descibed below in
  252. detail.
  253.  
  254. From a  Shell, CanonStudio is invoked by typing "CanonStudio".
  255. CanonStudio has the following command template for it's arguments.
  256.  
  257.  
  258. CanonStudio PUBSCREEN/K,TOPAZ/S,REXX/S,NOFILEREQ/S,SCALE/S,
  259.             NOSCALE/S,SETTINGS/K,PRI=PRIORITY/K/N,UNIT/K/N,FILES/M
  260.  
  261. where SETTINGS is the name of a settings file for CanonStudio
  262. preferences.
  263.  
  264. Beside the SETTINGS option, both, tool type and shell argument can
  265. be used to override special preference settings or cause a
  266. different behaviour of CanonStudio:
  267.  
  268. PUBSCREEN <Name>
  269. allows opening CanonStudio on a public screen.
  270.  
  271. TOPAZ
  272. disable  independent font code.  CanonStudio will only use Topaz 8
  273. for rendering it gadgets.
  274.  
  275. REXX
  276. Will  open  ARexx  port after FILES/M got processed.  WARNING:  if
  277. REXX is specified, you can only quit CanonStudio by using the QUIT
  278. or CONITNUE command (see the ARexx-Interface chapter).
  279.  
  280. NOFILEREQ:
  281. If  files  are  specified during startup, these will be processed.
  282. No  filerequester  appears  after this and -- unless REXX has been
  283. specified -- CanonStudio is terminated.
  284.  
  285. FILES <name1> <name2>... :
  286. You may specify files for processing and printing.
  287.  
  288. SCALE|NOSCALE  (default SCALE)
  289. In  case  SCALE  is  used,  CanonStudio  checks  if  the  IFF CMAP
  290. (colormap)  was shifted or scaled.  Some application programs (for
  291. instance  DPaint  4.1)  do write their color values shifted (0xF0)
  292. instead  of  scaled (0xFF) causing to dark colors.  As default you
  293. should  start  CanonStudio  with  the  SCALE  option  and save the
  294. setting.   Newer  programs do write their color values scaled (for
  295. instance  ADPro).   Usually do not care about this setting, except
  296. you get light grey instead of a white area.
  297.  
  298. PRI=PRIORITY <num>  (Default -1)
  299. Defines  the  process  priority  of  the  main  print process.  As
  300. default  a  value  of  -1  is  set.   This  results  in  a  better
  301. multitasking  behaviour as you may go further while CanonStudio is
  302. printing  in  background.   Most  Amiga  processes  have  a higher
  303. priotity of 0. The priority must be in range from -50 to 50.
  304.  
  305. NOTE:  In case there is an other task with higher priority running
  306. in  background,  CanonStudio  may  seem to be disabled or crashed,
  307. though  this  is  not the case simply because CanonStudio does not
  308. get  any computing time because of it's lower priority compared to
  309. the  other  task.   In this case quit or halt the other task while
  310. CanonStudio is running, or increase the CanonStudio priority using
  311. the PRIORITY option.
  312.  
  313. UNIT <num>     (Default 0)
  314. Future  Workbench  printer preferences may allow you top specify a
  315. printer  port  to  print  at.  Also, most of the current multiport
  316. cards  allow  you  to  specify a port for printing at using a unit
  317. number  (ie.  0 = internal port, 1 = external port A, 2 = external
  318. port B,...).
  319. Using the UNIT tool type or CLI keyword, you can define a unit
  320. (ie. port) to print at. As default, unit 0 is used.
  321. Once specified you can save the unit in the CanonStudio settings
  322. file.
  323.  
  324.  
  325. NOTE:   in  case  the settings file could not be read, CanonStudio
  326. automaticly   sets   the   dither   method   to  custom  with  the
  327. Ordered-A-256  dither  method  installed.   So  the first time you
  328. start, Ordered is installed as "Custom Dither".
  329.  
  330.  
  331.                            GETTING STARTED
  332.                            ---------------
  333.  
  334. After starting CanonStudio a filerequester appears and ask you for
  335. selecting IFF files for printing.  You can avoid the filerequester
  336. by specifying files as arguments on shell startup, and/or by using
  337. the NOFILEREQ option.
  338.  
  339. Also,   in   case   you  start  CanonStudio  from  Workbench,  the
  340. filerequester  can  be avoided by multiselecting the picture icons
  341. (see your system manual for more information).
  342.  
  343. In  either  case,  Shell  or  Workbench,  a filerequester does not
  344. appear  in  case  you  already  have  specified a picture file on
  345. startup.   In case no file is given, the filerequester appears and
  346. you   can   multiselect   (again,   see  your  system  manual  for
  347. multiselection) files for printing.
  348.  
  349. In  case  you  are  not  sure about printing a special file, don't
  350. hesitate.   Unless  you  have  specified  the  NOFILEREQ option on
  351. startup,  the filerequester will appear again after processing the
  352. other given files.
  353.  
  354.  
  355.                         THE MAIN PROCESS WINDOW
  356.                         -----------------------
  357.  
  358. After  successfully  selecting  the  file(s), the two main process
  359. windows  open.  One window is sized as far as your monitor allows.
  360. This window gives you an overview of the size of the printing page
  361. and  the  picture size and position for printing.  You can use the
  362. mouse to position and size the picture on page.
  363.  
  364. While  you  use the mouse for positioning the picture on the page,
  365. the  gadgets  in the second window are updated accordingly.  These
  366. gadgets  show  the extact numeric values of the selections made by
  367. mouse in the other window.
  368.  
  369. Also,  this  smaller  window  contains all the gadgets you need to
  370. control  color, dither method and more.  Most of the gadgets don't
  371. need  a  huge  explanation,  so  let's have an overview over these
  372. gadgets:
  373.  
  374.  
  375.  
  376.  
  377. Paper Dimension:
  378. These  are  two  gadgets.   One  is  showing  you the width of the
  379. maximum  printable  area  of your printer as yelled by the printer
  380. driver.   This  gadget is read-only.  The other gadget defines the
  381. height  of  the  maximum  printable  area  of  your printer.  This
  382. setting is often defined as physical print page.  For instance, in
  383. case  you  have a DIN A4 paper with a size of 21.0*29.7cm and your
  384. printer always leaves a top and bottom border of 1 cm, you should
  385. enter 27.7cm here.
  386.  
  387.  
  388.  
  389.  
  390. Page Dimension:
  391. Now  that  you have defined the maximum print area of your printer
  392. for  a  given  paper  size,  you may define a wanted subpage.  For
  393. instance, you may want to decrease the printable size if you have
  394. a  DIN  A4  sized paper with sign at the top which should never be
  395. overprinted  (or  a formular paper).  Let's say the sign is at the
  396. top  border  and  2  cm height.  Now you should decrease the print
  397. height  from  Paper  Dimension  by  two (ie.  25.7cm) and define a
  398. border of 2 cm at the top (Page Dimension Y = 2cm).
  399.  
  400.  
  401.  
  402.  
  403. Print Dimension:
  404. And  finaly  we have the actual print size of the picture.  The is
  405. nearly  no  limit  to  the  size specified here.  Just be sure the
  406. upper left corner of the picture will be printed on the first page
  407. (if  not,  you'll  get  an  error requester anyway...).  The Print
  408. Dimensions X will be applied to all of the left-most pages in a
  409. poster print.  All of the top most pages of a poster print will be
  410. affected by the Print Dimensions Y setting.
  411.  
  412.  
  413.  
  414. Density:
  415. This  cycle  gadget in the upper right of the window shows you the
  416. densities  supported  by  the  printer  driver.   Select  a wanted
  417. density by simply clicking with the mouse on the gadget.
  418.  
  419.  
  420.  
  421. Col / b/w
  422. Below the Density gadget, you find the color and b/w cycle gadget.
  423. This gadget allows you to select the output of a color picture:
  424. greyscale or color. In case you select color and your printer
  425. driver does not support color, greyscale is used automaticly.
  426.  
  427.  
  428.  
  429.  
  430. Single/Fanfold
  431. This   gadget   does   the   same  as  the  Workbench  preferences
  432. Single/Fanfold  gadget.  In case Single is selected, a Formfeed is
  433. send  after  each  page.   Fanfold  should  be used for endless or
  434. rolled paper.
  435. If  you have a single sheet ONLY printer like a laser printer, you
  436. can  use  FanFold to print multiple pictures on one page.  Just be
  437. sure  to set the page and paper dimension accordingly.  If you are
  438. printing  a  multicolumn  poster  on  continuous paper (fanfold or
  439. roll)  then  you  would  set  "Fanfold" and define some top margin
  440. (Print  Dimensions  Y)  so  that the columns of your print will be
  441. separated.   Also,  when printing posters on continuous paper, you
  442. should  set  the Page Definitions Top margin to 0 so that there is
  443. no gap between individual pages of a column.
  444.  
  445.  
  446.  
  447.  
  448.    Custom/Floyd/Stucki/Jarvis/Blue Noise 30%/Blue Noise 50%
  449.  
  450. This cycle gadget allows you to select a wanted dither method.
  451. The dither method themselves are discussed later in detail.
  452. However, the print time increases with the dither method listed
  453. below. For instance Blue Noise usually requires twice the print
  454. time of the any Custom dither.
  455.  
  456. o  Custom  allows  you  to define any wanted ordered dither matrix
  457. using  the  "Define  Dither"  gadget  below.   Many preset ordered
  458. dither matrixes are provided and explained later in detail
  459.  
  460. o Floyd Steinberg is a very popular error diffusion dither method.
  461. This  dither  method  does  provide a good compromiss of speed and
  462. quality.
  463.  
  464. o  Stucki  is also an error diffusion dither method.  Different to
  465. Floyd Steinberg, this dither does require more computing time as a
  466. result of taking more pixels into the account.
  467.  
  468. o  Jarvis  is  also  an error diffusion algorithem with nearly the
  469. same  output  as the Stucki dither.  The added computation time of
  470. the Jarvis and Stucki dithers results from incorporating a greater
  471. number of pixels into each dithering computation.
  472.  
  473. o Blue Noise 30%
  474. This  is  an  error  diffusion  algorithem with perturbation and a
  475. serpentine raster using the Floyd Steinberg filter with 30% random
  476. weights.
  477.  
  478. o Blue Noise 50%
  479. This  is  an  error  diffusion  algorithem with perturbation and a
  480. serpentine raster using the Floyd Steinberg filter with 50% random
  481. weights.
  482.  
  483. If  you  want  to  read  more  about  dither  routines and digital
  484. halftoning, here is a very good book to go for:
  485.  
  486. Robert Ulichney
  487. "Digital Halftoning"
  488. MIT Press
  489. ISBN 0-262-21009-6
  490.  
  491. The  book  is  easy  to  understand  and  does  come with lot's of
  492. samples.   Most of the dither routines described below are handled
  493. in  detail  in  this  book.   Surely one of the best books when it
  494. comes to digital halftoning.
  495.  
  496.  
  497.  
  498.  
  499. Color Adjust...
  500. A window will appear when you click on this gadget. The window
  501. contains many sliders giving you a possibility of to control the
  502. color, brightness and more of your picture. While most functions
  503. should be known, some note should be made:
  504.  
  505. -  the  gamma  sliders  allows  you to bright up a picture without
  506. loosing  to  much  colors.   Specially owners of printers with dot
  507. gain  problems  (most  "cheap"  printers  <$3000  do have dot gain
  508. problems!)  should  use  this  slider  to increase the brightness.
  509. Usually, you should select a value from 20-30 for best printing on
  510. the CanonBJC800, BJ10, BJ300. 
  511.  
  512.  
  513. - the weights sliders are importend for printing color pictures on
  514. greyscale printers.  The color components of the color picture are
  515. weighted  accord  to  the  slider settings.  What are weights good
  516. for?  A red and green pixel, both with the same color value of 50,
  517. do  not have the same luminance when they are displayed on a color
  518. monitor.   Most likely the green will look brighter because of the
  519. way  monitor  tubes are build.  Because of this, when converting a
  520. color  picture  previously  displayed  on a monitor to a greyscale
  521. picture,   you   have  to  consider  the  different  weights  (ie.
  522. luminance)  of  the tube colors.  As default, CanonStudio uses the
  523. weights as defined by the NTSC and PAL standard.  In case you have
  524. scanned  a picture with a RGB scanner, the colors are not weighted
  525. to  these  standards and are most likely weighted equaly.  In this
  526. all  sliders  should  be  set to 3333 (ie.  33.33%) resulting in a
  527. total weight of 100%.  The total weighting may exceed 100 percent.
  528.  
  529. -  CanonStudio  also offers the user complete control over its ink
  530. compensation  function.   Printer's  inks  are not completely pure
  531. materials.  For example, there is some amount of yellow mixed into
  532. the  magenta  ink.   And,  there  is  some amount of magenta which
  533. unavoidably is found in the cyan ink.  The ink compensation values
  534. will  correct for these impurities.  With Magenta Compensation you
  535. define  the  amount  of  magenta in the cyan ink in percent.  With
  536. Yellow Compensation you define the amount of yellow in the magenta
  537. ink  in  percent.   In  general, set the ink compensation value of
  538. magenta  31%  and  yellow to 40% for best results with Inkum Inks.
  539. PS:   on  my  experience  15%  gives better violet shades with the
  540. original  Canon  BJC800  inks, but again...  it's best you ask the
  541. manufacturor  of  the  ink  for  the right values.
  542.  
  543. NOTE:  The ink compensation function can be completely disabled by
  544. defining  0%.   You  will notice that without the ink compensation
  545. function,  a  blue  sky  will  print  as  purple.   With  the  ink
  546. compensation function set at 31%, blue skies are blue again.
  547.  
  548.  
  549.  
  550. Set Aspect
  551. When  you click on this gadget, CanonStudio automatically sets the
  552. print  height  of  your  picture  to  a value so that your printed
  553. picture does have the right aspect ratio.  This requires a correct
  554. aspect  ratio  or  DPI chunk saved in your picture.  After setting
  555. the  correct  aspect  ratio,  a  circle is printed as circle and a
  556. square  would  be  printed  as  square no matter what the physical
  557. aspect of the printer's dots are.
  558.  
  559.  
  560.  
  561. cm/inch
  562. Every  value  shown  in  the windows can defined as centimeters or
  563. inches.   This  gadget  shows  the  current selection and when you
  564. click on it, all values are changed to the other measurement.
  565.  
  566.  
  567. Copies
  568. Allows you to define the number of copies you wish to print of the
  569. picture.
  570.  
  571.  
  572. Startin page
  573. In case you print a poster, you may define a page to start
  574. printing with. This is specialy usefull for printing posters. In
  575. case you had some trouble with the printer in the middle of the
  576. printing (out of paper?), you may restart the printing with the
  577. page aborted.
  578.  
  579.  
  580.                        PRINTING THE PICTURES
  581.                        ---------------------
  582.  
  583. After  all settings have been done in the main process window, you
  584. can  click  on  the  "Print"  button.   A small status window will
  585. appear  telling  you  the  number  of pages, copies and after some
  586. seconds the estimated printing time.
  587.  
  588. CanonStudio  includes  a  printer  spooler  of  it's  own  (called
  589. MultiTasking  hihi).   Because  of  this,  you can go further with
  590. selecting  pictures  for  printing  while  the  printer  is  still
  591. printing.  The main window will appear with the next picture file
  592. in case you selected multiple pictures on startup. After defining
  593. the print size of all given pictures, the filerequester appears
  594. again.
  595.  
  596. There  is  nearly  no  limit  in  predefining multiple print jobs!
  597. Also,  you  can  define  the  priority  of the printing process on
  598. startup  of  CanonStudio  and save this setting by clicking on the
  599. "Save  Setting" gadget.  If you set this priority to a less than 0
  600. (default  -1),  printing  is done in background without disturbing
  601. you  while  defining the print dimension of the next picture or do
  602. whatever you like to do with your Amiga (except power off ;-).
  603.  
  604.  
  605.                          QUIT CANONSTUDIO
  606.                          ----------------
  607.  
  608. You  can  terminate  CanonStudio by clicking on the filerequesters
  609. close gadget or the Quit gadget.
  610.  
  611.  
  612.  
  613.                          THE STATUS WINDOW
  614.                          -----------------
  615.  
  616. The status window appears on startup of CanonStudio and remains
  617. open until you quit CanonStudio. While printing the window is
  618. sized to its maximum size and shrinked to a small title bar while
  619. not printing. The status window displays the current print job in
  620. progress and estimated printing time.
  621. Two gadgets are in this window and enabled in case a picture is
  622. printed:
  623.  
  624. "Aborts" the printing of all pictures.
  625. "Skip"  skips the current picture and printing will start with the
  626. next picture.  Also, a requester appears to make sure your printer
  627. is ready for the next picture in case of an previous problem.
  628.  
  629.  
  630.  
  631.                           PRINTER DRIVERS
  632.                           ---------------
  633.  
  634. CanonStudio  was designed to work with most Amiga printer drivers.
  635. Though,  as  result  of the major efforts from Canon in supporting
  636. the  Amiga,  currently  only Canon users get the program for free.
  637. Because  of  this,  CanonStudio  was  limited  to  work with Canon
  638. drivers. In case the printer driver support it's own kind of color
  639. adjustment or dither routines: turn them off! Usually this can be
  640. easily done by printing using density 1 or 2. See your printer
  641. driver manual for more details.
  642.  
  643.  
  644.                           DITHER ROUTINES
  645.                           ---------------
  646.  
  647. Many  dithering  methods are supplied with the CanonStudio.  These
  648. are  described  below.   In  each  case  a larger dither mask size
  649. produces  a  print which can represent a wider range of colors but
  650. will  produce  less  spatial  information  per unit area of paper.
  651. Conversely,  a smaller dither mask size can reproduce fewer colors
  652. (or  shades)  but more closely approximates the true resolution of
  653. your printer.
  654.  
  655. Another  way  of  expressing  this  is  the following:  There is a
  656. tradeoff  between printing ``lots'' of colors and printing in high
  657. resolution.    Given  a  specific  printer  with  a  specific  DPI
  658. capability,  asking  for  ``lots''  of colors means using a larger
  659. dither  mask  size.   A  larger dither mask size cuts down on your
  660. effective  resolution.  For instance, using a dither mask of 16*16
  661. on  your 360dpi printer will result in 360/16 = 22.5 dpi with full
  662. color information.
  663.  
  664. Note  that  this can work to your advantage when blowing a picture
  665. up  in  size.  Blowing up a picture means that there are more dots
  666. to  work  with  which  offsets  the loss in resolution caused by a
  667. larger  dither mask size.  This added to the benefits to be had by
  668. being  able  to  reproduce more colors (or shades) means that your
  669. enlarged posters will look quite good.
  670.  
  671. Also note that many printers including most laser printers and dot
  672. matrix  printers  have  considerable dot gain.  For example, a 360
  673. DPI  laser printer does not actually print dots which are 1/360 of
  674. an  inch  in  size.   Rather,  its dots will be much larger.  This
  675. causes  some  dithers,  such  as  the  Floyd-Steinberg and Ordered
  676. dithers,  to  produce  intensely  over-saturated  or muddy prints.
  677. Other  dithers  such  as  the  two  halftone dithers overcome this
  678. problem with low-end printers.
  679.  
  680. Also,  if  you want to read more about dither routines and digital
  681. halftoning, here is a very good book to go for:
  682.  
  683. Robert Ulichney
  684. "Digital Halftoning"
  685. MIT Press
  686. ISBN 0-262-21009-6
  687.  
  688. The  book  is  easy  to  understand  and  does  come with lot's of
  689. samples.   Most of the dither routines described below are handled
  690. in  detail  in  this  book.   Surely one of the best books when it
  691. comes to digital halftoning.
  692.  
  693. Now let's take a look at the supplied dither routines. 
  694.  
  695.  
  696.  
  697.                            Custom
  698.                            ------
  699.  
  700. If the Custom dither method is selected, you can define or load
  701. any ordered dither matrix by click on the "Define Dither" method
  702. below the gadget. Several popular ordered dither method are
  703. provided with CanonStudio and saved in a file. These file can be
  704. loaded and enabled with the "Load" gadget.
  705.  
  706. The  amount of printable colors is usually directly related to the
  707. size  of the dither matrix.  The ordered dither routines described
  708. below  usually  exists  in several sizes.  You can distinguish the
  709. custom ordered dither routines by their filenames.  For instance a
  710. filename  of  "Halftone-A-4"  means:  Halftone A dither routine, 4
  711. shades.  While "Halftone-A-256" means:  Halftone A dither routine,
  712. 256 shades.
  713.  
  714.  
  715.               Halftone-A - <number of colors>
  716.               Halftone-B - <number of colors>
  717.  
  718.  
  719. The  halftone  dithers  (Halftone-A  and Halftone-B) differ in how
  720. they place a halftone matrix.
  721.  
  722. This  is the classical clustered halftone method used by most book
  723. publishers.   To improve the dither output, the halftone matrix is
  724. rotated  by  45 degree.  Halftone-A causes the halftone matrix for
  725. each  of  the  primary colors to be centered about the same point.
  726. This  means  that  the  primary  colors  will  overlap completely,
  727. leaving  a  lot  of  white  paper  showing  through.   This may be
  728. appropriate for some better dye sublimation type printers or other
  729. color printers with good registration where the inks mix well.
  730.  
  731. Halftone-B,  on  the  other  hand, staggers the halftone matrix of
  732. each  primary  color so that they do not overlap.  This is similar
  733. in  concept  to traditional color offset printing.  Halftone-B may
  734. produce better results on printers whose inks do not mix well, and
  735. on printers with less than perfect registration.
  736.  
  737. The  halftone dithers can produce some extremelly good results and
  738. compensate  for  the  dot  gain problems outlined above.  Try both
  739. halftone  dithers  to  see which one is better for your particular
  740. intention.
  741.  
  742. Also, in case you xerox your printing, using Halftone results in a
  743. much better copy.
  744.  
  745. To  use  Halftone-B  is  somehow  different  to  the  other dither
  746. matrices.   You  have  a  special  dither  matrix  for each color.
  747. Because of this, each dither filename includes the abbreviation of
  748. the  color  (C  =  cyan,  Y  =  yellow,  M = magenta, K = black or
  749. greyscale).   In case you use Halftone-B you also have to increase
  750. the  brightness  of  the  black  color  component by 50%.  Use the
  751. bright+ gadget in the CanonPref program for increasing brightness.
  752.  
  753. Halftone-B is a nice example for the relationship between color
  754. adjustment and dither routines. You have to consider both setting
  755. up your driver.
  756.  
  757.  
  758.  
  759.  
  760.                  PrtDevice-Halftone-16
  761.                  PrtDevice-Ordered-16
  762.  
  763.  
  764.  
  765. This dither matrix is the one used by the printer devices
  766. "Halftone" or "Ordered" dither.
  767.  
  768.  
  769.  
  770.                  Ordered-A - <number of colors>
  771.  
  772.  
  773.  
  774. The  ordered  dither produces a regular repeating pattern which is
  775. often  used for printing computer graphics.  The ordered dither is
  776. particularly  susceptible  to  over-saturation  due to dot gain in
  777. high resolutions. Though, you surely get nice outputs in 180DPI.
  778.  
  779.  
  780.                  Ordered-B - <number of colors>
  781.  
  782. This  dither  is  a mixture of a dispersed dither like Order and a
  783. clustered  dither like Halftone.  The dither is specialy addressed
  784. to  the  high  resolution  printers  with  dot gain problems.  For
  785. instance,   if   you  print  a  picture  with  360*360  dpi  using
  786. Ordered-Rect-B-64, you get a picture that seems to be printed with
  787. 180*180  dpi.   Now  while  graphics are printed emulating 180*180
  788. dpi,  all  black  parts  of the picture are printed using 360*360.
  789. Don't  be  confused,  the  printed  picture  is  still better than
  790. a     picture     in     real    180*180dpi    resolution.     The
  791. Ordered-Rectangular-B is specialy usefull for color DTP. You get
  792. nice color pictures with fine high quality text.
  793.  
  794.  
  795.  
  796.             Spiral-Dot-Screen  - <number of colors>
  797.  
  798.  
  799. A  wide  range  of  special  effects clustered dither matrices are
  800. available  in  the  graphic  arts  industry  and  all  are  easily
  801. simulated digitally.  Spiral-Dot is such a dither.
  802.  
  803. The spirol-dot dither is essentially half of the classical screen,
  804. with   dark   squares  growing  to  fill  the  plane  without  the
  805. laternating  light squares.  Spiral-Dot looks quiet similar to the
  806. Halftone-A matrix 0 degree rotated.
  807.  
  808.  
  809.  
  810.             Horizontal  - <number of colors>
  811.             Vertical    - <number of colors>
  812.             FwdDiagonal - <number of colors>
  813.             BckDiagonal - <number of colors>
  814.  
  815.  
  816. A  wide  range  of  special  effects clustered dither matrices are
  817. available  in  the  graphic  arts  industry  and  all  are  easily
  818. simulated digitally.  The Line dithers are such dithers.
  819.  
  820. The  horizontal  (as  well  as  the vertical, forward diagonal and
  821. backward  diagonal)  dither overcome much of the dot gain problems
  822. that the Floyd and Ordered dithers have with inexpensive printers.
  823. These  dithers  (especially  the  diagonal dithers) are especially
  824. good for large printings.
  825.  
  826.  
  827.                         Floyd Steinberg
  828.                         ---------------
  829.  
  830. This is a very popular error diffusion dither method suggested by
  831. Floyd and Steinberg. They argued that a filter with four elements
  832. was the smallest number that could produce "good" results. The
  833. values were choosen to particulary assure the checkerboard pattern
  834. at  the  middle  grey  or shade of color.  This dither method does
  835. provide  a good compromiss of speed and quality.  The reason for the
  836. popularity of this algorithem is clear, several color shade levels
  837. are    represented    by   pleasingly   isotropic,   structureless
  838. distributions  of  dots.   However,  some  shortcomings  are  also
  839. apparent:
  840.  
  841. 1. Correlated artifacts in many of the color shade level patterns.
  842. This can be easily seen by printing a grey scale ramp.
  843.  
  844. 2. Directional hysteresis due to the raster order of processing.
  845. This artifact is most apparent in very light and very dark
  846. patterns.
  847.  
  848. 3. Transient behavior near edges or boundaries.
  849.  
  850.                     Jarvis, Judice and Ninke
  851.                     ------------------------
  852.  
  853. In 1976 Jarvis, judice and Ninke reported an error filter with 12
  854. elements. The large filter size does reduce some of the artifacts
  855. seen with the 4 element filter of Floyd and Steinberg, but
  856. directional hysteresis in the very dark and light regions are
  857. increased, and pixels are clustered together more in the middle of
  858. color shade regions. It also sharpen the pictures more.
  859.  
  860.                             Stucki
  861.                             ------
  862.  
  863. The Stucki filter uses does provide nearly the same output as the
  864. Jarvis filter, though you may may notice differences in sharpness.
  865.  
  866.  
  867.                         Blue Noise 30%-50%
  868.                         ------------------
  869.  
  870. In trying several combinations of deterministic values in a four
  871. element error filter, non proved better than the famed filter of
  872. Floyd and Steinberg. Two variations of this basic filter are the
  873. Blue Noise dither included with CanonStudio. Both are processed
  874. with  serpentine rasters. The serpentine raster used in processing
  875. is responsible for much of the directional artifact elemination.
  876. The noisy treshold (30% or 50% white noise) breaks up most of the
  877. remaining stable texture patterns yielding good radial symmetry at
  878. the expense of adding some low frequency energy. 
  879.  
  880. Blue noise is specialy usefull when printing light shades and
  881. fading colors.
  882.  
  883. All  error  diffusion dither including Blue Noise can produce very
  884. good  results on color printers with little dot gain and very good
  885. registration.   If  it produces a washed out print or particularly
  886. bad patterns, then try another dither (see the custom Ordered-B or
  887. Halftone for instance).
  888.  
  889.  
  890.                           ARexx Interface
  891.                           ===============
  892.  
  893.  
  894. By  using  the powerful scripting language, ARexx, CanonStudio can
  895. be  controlled  for  automatic print jobs.  Nearly every aspect of
  896. CanonStudio can be controlled from ARexx using simple English-like
  897. commands.   This  chapter  describes the usage of CanonStudio from
  898. ARexx.
  899.  
  900. Note  that  you  must  have  ARexx  in order to use the facilities
  901. described  in  this  chapter.  Specifically, if the program cannot
  902. locate  the library "rexxsyslib.library", then it will not respond
  903. to  any  ARexx  style requests.  Also, CanonStudio must be startet
  904. with the REXX option (CLI or TOOLTYPE) to enable the ARexx port.
  905.  
  906.  
  907. In order to access CanonStudio from ARexx, you must tell ARexx how
  908. to  make  contact  with  CanonStudio.  Specifically, you must tell
  909. ARexx  the  name of the message port which CanonStudio creates for
  910. the purpose of ARexx interaction.
  911.  
  912. The  port name of the program is called "PRTSTUDIO.n" where "n" is
  913. an extension starting with "1" making the port unique.
  914.  
  915. Note:   the  name  "PRTSTUDIO"  is  not  an  ARexx  port unique to
  916. CanonStudio.   This port will also be used by similar programs for
  917. other  printer manufacturers.  They all use the same ARexx port and
  918. do  have  a common ARexx comand set so you can share ARexx scripts
  919. with those users.
  920.  
  921. You  can  make  the connection from ARexx to CanonStudio using the
  922. following ARexx command:
  923.  
  924.                         address "PRTSTUDIO.1"
  925.  
  926. ARexx  will  generate an error condition should CanonStudio not be
  927. found.
  928.  
  929. Note  that  the  ARexx  port  name  is  case specific.  It must be
  930. specified exactly as shown above.
  931.  
  932. Results:
  933. --------
  934.  
  935. After   every  command  directed  at  CanonStudio  from  ARexx  is
  936. executed,  CanonStudio  will  fill  in  the  standard ARexx result
  937. variable, "RC", with a return value.  If this value is 0, then the
  938. previous  command executed without error.  If the value of "RC" is
  939. not zero, then it contains an error severity indicator.
  940.  
  941. In  order  to  receive  additional error indications or to receive
  942. non-error  status  information  back  from  CanonStudio,  you must
  943. request   additional  status  information  from  ARexx  using  the
  944. following command:
  945.  
  946.                             OPTIONS RESULTS
  947.  
  948. This  command  must be one of the first executable instructions in
  949. your ARexx program.
  950.  
  951. If  an "options results" command has been issued, then CanonStudio
  952. will   load   additional   information  into  the  ARexx  variable
  953. "PRTSTUDIO_RESULT".   "PRTSTUDIO_RESULT" can be consulted whenever
  954. {\tt  RC}  is  non-zero  to  gain additional information about the
  955. nature of an error.
  956.  
  957. When  RC  is  returned  with  a  zero  value  (indicating no error
  958. occurred),  "PRTSTUDIO_RESULT"  will  be  set  to command specific
  959. information.   Note  that  this  means  you must check "RC" before
  960. depending    on    the    data    in    "PRTSTUDIO_RESULT"   since
  961. "PRTSTUDIO_RESULT" may contain either additional error information
  962. or the status information you requested.
  963.  
  964. The  "PRTSTUDIO_RESULT"  variable  is available only to true ARexx
  965. programs.   If you are sending ARexx style commands to CanonStudio
  966. from  a  non-ARexx  program,  then results which normally would be
  967. passed  back  in "PRTSTUDIO_RESULT" will instead be passed back in
  968. the "rm_Result2" field in the ARexx message structure.
  969.  
  970. When  CanonStudio is started with the REXX option, it will setup a
  971. database  of  your default values for printing.  The values of the
  972. database  can  than  be altered by using ARexx commands.  Once you
  973. have  setup  the values, you may call the PRINT command from ARexx
  974. and  CanonStudio will print the selected picture with the settings
  975. of  the  database.   You  can  go on with your ARexx script, while
  976. CanonStudio  prints  the  picture  in  background.   You  even may
  977. specify  an  unlimited  number  of  pictures for printing, while a
  978. CanonStudio is still printing the first picture.  CanonStudio does
  979. contain  a  printer  spooler  for keeping control of what has been
  980. printed (well, I would rather call this feature "Multitasking" ;-)
  981.  
  982. The  database  you  have  read  and/or  write access to from ARexx
  983. contains informations like:
  984.  
  985. PRINTDX  - print dimension x position in inch.
  986. PRINTDY  - print dimension Y position in inch.
  987. PRINTDW  - print dimension width in inch.
  988. PRINTDH  - print dimension height in inch
  989.  
  990. PAGEDX   - page dimension x position in inch.
  991. PAGEDY   - page dimension Y position in inch.
  992. PAGEDW   - page dimension width in inch.
  993. PAGEDH   - page dimension height in inch
  994.  
  995. PAPERDW  - printer page dimension width in inch - this value is read only!
  996. PAPERDH  - printer page dimension height in inch.
  997.  
  998. RULERDW  - ruler dimension width in inch.
  999. RULERDH  - ruler dimension height in inch.
  1000.  
  1001. COPIES    - numer of copies.
  1002. STARTPAGE - starting page.
  1003.  
  1004. DENSITY   - printer device density setting for printing
  1005.             DENSITY may range from 1 to 7.
  1006.  
  1007. DITHERMETHOD - dither method to use for printing
  1008.  
  1009. COLOR CONTROLS - control over the color adjustments.
  1010.  
  1011. and more...
  1012.  
  1013.  
  1014. Commands:
  1015. ---------
  1016.  
  1017. GETFILE
  1018. GETFILE "DEFAULTFILE"
  1019.  
  1020. Pops  up  the  filerequester  and  returns  the  selected  file in
  1021. "PRTSTUDIO_RESULT".   In  case  user aborted the requester without
  1022. selecting a file, RC will be set to 10 and "PRTSTUDIO_RESULT" does
  1023. contains the currently selected file.
  1024.  
  1025. SETFILE
  1026. SETFILE "PRINTFILE"
  1027.  
  1028. The first syntax returns the file set in the database. The second
  1029. syntax allows you to define a new picture for printing. The old
  1030. selection  will  be returned in "PRTSTUDIO_RESULT".  In both cases
  1031. no error is returned.
  1032.  
  1033. QUIT
  1034.  
  1035. Quits CanonStudio.
  1036.  
  1037. SCREENTOFRONT
  1038.  
  1039. Pops  the  CanonStudio  screen  to  front.   This command does not
  1040. return an error.
  1041.  
  1042. SCREENTOFRONT
  1043.  
  1044. Pushes  the CanonStudio screen to the back.  This command does not
  1045. return an error.
  1046.  
  1047. PANEL
  1048.  
  1049. Opens  the main processing window and allows the user to setup the
  1050. parameters  for  a  picture.   CanonStudio  returns  10  in RC and
  1051. "Aborted" in PRTSTUDIO_RESULT if the user aborted the panel window
  1052. with  cancel.   In  case an error appears or the selected file was
  1053. not a valid IFF file, RC contains 20 and PRTSTUDIO_RESULT "Illegal
  1054. file".
  1055.  
  1056.  
  1057. PRINTDW
  1058. PRINTDW SIZE
  1059. PRINTDH
  1060. PRINTDH SIZE
  1061. PRINTDX
  1062. PRINTDX SIZE
  1063. PRINTDY
  1064. PRINTDY SIZE
  1065. PAGEDW
  1066. PAGEDW SIZE
  1067. PAGEDH
  1068. PAGEDH SIZE
  1069. PAGEDX
  1070. PAGEDX SIZE
  1071. PAGEDY
  1072. PAGEDY SIZE
  1073. PAPERDW
  1074. PAPERDH
  1075. PAPERDH SIZE
  1076. RULERDW
  1077. RULERDH
  1078.  
  1079. Using  these  commands  you  can  ask  or set a size parameter for
  1080. printing.   SIZE  must  be defined in the actual measurement CM or
  1081. INCH.  Make sure you set the measurement previously.  In case SIZE
  1082. is  illegal,  PRTSTUDIO_RESULT returns "Illegal value" with RC set
  1083. to  10.   In case of an error, the size parameters in the database
  1084. are  altered to a legal value.  While you may alter a setting with
  1085. these  commands,  it's not recommended to set all parameters.  Use
  1086. the SETSIZE command instead.
  1087.  
  1088.  
  1089.  
  1090.  
  1091. SETSIZE PRINTDW PRINTDH PRINTDX PRINTDY PAGEDW PAGEDH PAGEDX PAGEDY PAPERDH
  1092.  
  1093. With  this  command you can set multiple print parameters with one
  1094. command.  You may specify as many arguments as you need as long as
  1095. you  conform the order above.  This command avoids possible errors
  1096. that  might  appear with the single size set commands (PRINTDW...)
  1097. because  of temporary invalid parameters.  As result, this command
  1098. returns the previous settings of:
  1099.  
  1100. PRINTDW PRINTDH PRINTDX PRINTDY PAGEDW PAGEDH PAGEDX PAGEDY PAPERDW PAPERDH
  1101.  
  1102. Note  that  you also get PAPERDW as result.  You may use the ARexx
  1103. parse  command  for  assigning each value to a wanted var in ARexx
  1104. scripts.
  1105.  
  1106. In  case  of an error, RC returns 10 and PRTSTUDIO_RESULT "Illegal
  1107. value".
  1108.  
  1109.  
  1110. CM
  1111.  
  1112. Sets the measurement to centimeters.  Automatically transforms the
  1113. values  in  the  database  to centimeters.  As result the previous
  1114. setting  "INCH" or "CM" is returned in PRTSTUDIO_RESULT.  No error
  1115. is reported.
  1116. NCH
  1117.  
  1118. Sets  the  measurement to inch.  Automaticly transforms the values
  1119. in the database to inch.  As result the previous setting "INCH" or
  1120. "CM" is returned in PRTSTUDIO_RESULT.  No error is reported.
  1121.  
  1122.  
  1123. FANFOLD
  1124.  
  1125. Sets  paper  type  to  fanfold.   As  result  the previous setting
  1126. "FANFOLD"  or  "SINGLE" is returned in PRTSTUDIO_RESULT.  No error
  1127. is reported.
  1128.  
  1129. SINGLE
  1130.  
  1131. Sets  paper  type  to  single.   As  result  the  previous setting
  1132. "FANFOLD"  or  "SINGLE" is returned in PRTSTUDIO_RESULT.  No error
  1133. is reported.
  1134.  
  1135. DITHER
  1136. DITHER CUSTOM|FLOYD|JARVIS|STUCKI|BNOISE30|BNOISE50
  1137.  
  1138. Sets  the requested dither method.  As result the previous setting
  1139. is  returned  in PRTSTUDIO_RESULT.  In case of an error, RC is set
  1140. to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1141.  
  1142. VERSION
  1143.  
  1144. Returns the current version of CanonStudio (ie. "1").
  1145.  
  1146.  
  1147. COPIES
  1148. COPIES NUMBER
  1149.  
  1150. Sets  the  amount  of  copies  to  print.   As result the previous
  1151. setting  is returned in PRTSTUDIO_RESULT.  In case of an error, RC
  1152. is set to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1153.  
  1154. STARTPAGE
  1155. STARTPAGE NUMBER
  1156.  
  1157. Sets  the  page  to  start  printing with.  As result the previous
  1158. setting  is returned in PRTSTUDIO_RESULT.  In case of an error, RC
  1159. is set to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1160.  
  1161. DENSITY
  1162. DENSITY 1-7
  1163.  
  1164. Set the print density.  As result the previous setting is returned
  1165. in  PRTSTUDIO_RESULT.   In  case  of an error, RC is set to 10 and
  1166. PRTSTUDIO_RESULT to "Illegal value".
  1167.  
  1168. MAGENTA
  1169. MAGENTA 0 - 100
  1170. YELLOW
  1171. YELLOW 0 - 100
  1172.  
  1173. Sets  the  ink  compensation.   As  result the previous setting is
  1174. returned  in  PRTSTUDIO_RESULT.  In case of an error, RC is set to
  1175. 10 and PRTSTUDIO_RESULT to "Illegal value".
  1176.  
  1177. RED
  1178. RED -50 - 50
  1179. GREEN
  1180. GREEN -50 - 50
  1181. BLUE
  1182. BLUE -50 - 50
  1183. GAMMA
  1184. GAMMA -50 - 50
  1185. CONTRAST
  1186. CONTRAST -50 - 50
  1187. BRIGHT
  1188. BRIGHT -50 - 50
  1189.  
  1190. Sets  the color adjustment values.  As result the previous setting
  1191. is  returned  in PRTSTUDIO_RESULT.  In case of an error, RC is set
  1192. to 10 and PRTSTUDIO_RESULT to "Illegal value".
  1193.  
  1194. REDWEIGHT
  1195. REDWEIGHT   0 - 20000
  1196. GREENWEIGHT
  1197. GREENWEIGHT 0 - 20000
  1198. BLUEWEIGHT
  1199. BLUEWEIGHT  0 - 20000
  1200.  
  1201. Sets  the color weights for the color->greyscale transformation in
  1202. 1/100  percent.   As  result  the  previous setting is returned in
  1203. PRTSTUDIO_RESULT.   In  case  of  an  error,  RC  is set to 10 and
  1204. PRTSTUDIO_RESULT to "Illegal value".
  1205.  
  1206. CONTINUE
  1207.  
  1208. After this sending this command, the CanonStudio ARexx port is
  1209. removed and the program will pop up the file requester as if it
  1210. was started from CLI/Workbench without the REXX parameter. If
  1211. the user quits the filerequester, he also quits CanonStudio.
  1212.  
  1213. WARNING: do not send further messages after sending this command!
  1214.  
  1215. PRINT
  1216. PRINT WAIT
  1217.  
  1218. With  PRINT  the  currently  selected  file  will be placed in the
  1219. printing  queue  with  the  parameters  set  in the database.  The
  1220. control  is  returned  to  ARexx  directly  after  specifying this
  1221. command.   This  means,  the  ARexx  program  may go further while
  1222. CanonStudio  prints  in background.  Because of this, you'll never
  1223. receive  a  error message, wether the file was succesfully printed
  1224. or  not.   Though,  you  may  get  an error  in  RC  and  a proper
  1225. explanation in PRTSTUDIO_RESULT because of illegal settings in the
  1226. database.
  1227. Different to PRINT, PRINT WAIT does halt your ARexx program until
  1228. the  picture you specified has been printed.  In case the printing
  1229. was  aborted  by some reason, RC is set to 10 and PRTSTUDIO_RESULT
  1230. to "Aborted". Note: skiping the picture does not set RC to 10!
  1231.  
  1232. SETASPECT
  1233.  
  1234. Sets  the print dimension height (PRINTDH) according to the aspect
  1235. of the selected picture.
  1236. Note: to find out the aspect of a picture, CanonStudio has to scan
  1237. the picture file. Because of this, expect floppy users may have to
  1238. wait  some  seconds  until your ARexx program is further executed.
  1239. Also, a  valid picture file must be given
  1240. SETASPECT    returns    the   previously   selected   PRINTDH   in
  1241. PRTSTUDIO_RESULT.
  1242.